{extend name="layout" /}

{block name="title"}
<title>列表页面 - thinkPHP极速后台开发</title>
<meta name="title" content="列表页面 - thinkPHP极速后台开发">
<meta name="keywords" content="列表页面,php,后台开发包，thinkphp、easyadmin、admin,easy,thinkeasyadmin">
<meta name="description" content="列表字段,快速配置列表的样式,设置列表的模板;easyadmin灵活可定制的thinkphp的后台开发工具包,助你快速开发后台">
{/block}

{block name="main"}

<blockquote class="layui-elem-quote">列表页面</blockquote>
<fieldset id="liseField" class="layui-elem-field">
    <legend>列表配置</legend>
    <div class="layui-field-box">

        <p>默认会读取数据表的字段展示到列表,不过一般情况下都会重写<code>configListField</code>方法来实现自己的需求: </p>
        <pre class="php">
#project\app\admin\controller\Category.php

namespace app\admin\controller;

use easyadmin\app\columns\lists\ListDateTime;
use easyadmin\app\columns\lists\ListImage;
use easyadmin\app\columns\lists\ListText;
use easyadmin\app\libs\ListField;

class Category extends \easyadmin\controller\Admin
{
    protected $pageName = '分类';

    protected function configListField(ListField $list)
    {
        $list
            ->addField('id', 'ID', ListText::class)
            ->addField('name', '分类名称', ListText::class)
            ->addField('icon', '图标', ListImage::class)
            ->addField('time', '创建时间', ListDateTime::class);
    }

}

</pre>
        <p>当然我们有很多字段配置和选项,我们会一步一步的介绍;</p>
        <p>如上配置以后,就展示了自己特定需求的数据表格; 页面主体部分如下:</p>
        <img src="/doc_img/field.png" alt="列表">
        <fieldset class="layui-elem-field layui-field-title">
            <legend>addField 方法 参数说明:</legend>
            <div class="layui-field-box">
                <table class="layui-table">
                    <thead>
                    <tr>
                        <th>字段</th>
                        <th>说明</th>
                        <th>类型</th>
                        <th>必填</th>
                        <th>默认值</th>
                    </tr>
                    </thead>
                    <tbody>
                    <tr>
                        <td>field</td>
                        <td>字段名称;数据库表的字段,例如:<code>name</code>; 如果是<a href="{:url('lists_join')}#join">多表关联查询</a> ,需要写上关联表的别名,例如:<code>user.name</code> ;</td>
                        <td>string</td>
                        <td>是</td>
                        <td></td>
                    </tr>
                    <tr>
                        <td>label</td>
                        <td>字段标题,显示名称</td>
                        <td>string</td>
                        <td>是</td>
                        <td></td>
                    </tr>
                    <tr>
                        <td>fieldClass</td>
                        <td>渲染字段的类名; 例如是使用 ListText 类渲染本字段,则填写 ListText::class ; <a href="{:url('list_field')}">详见预定义字段</a>
                        </td>
                        <td>string</td>
                        <td>是</td>
                        <td></td>
                    </tr>
                    <tr>
                        <td>options</td>
                        <td>字段的选项; 不同的字段有不同的选项, <a href="{:url('list_field')}">详见预定义字段</a></td>
                        <td>array</td>
                        <td>否</td>
                        <td></td>
                    </tr>
                    </tbody>
                </table>
            </div>
        </fieldset>

    </div>
</fieldset>

{/block}


